|
|
This document describes how to upgrade to WebsydianExpress v1.2 from a previous version of WebsydianExpress (1.0/1.1) on the Windows/iSeries platform.
Please refer to WebsydianExpress 1.2 - What Is New? for information about new features and changes in WebsydianExpress v1.2.
For information on how to upgrade the Plex/Websydian development environment please read Upgrade Plex Development Environment to WebsydianExpress v1.2.
WebsydianExpress v1.2 is backward compatible with business processes developed with WebsydianExpress 1.0/1.1.
All objects in the PlaceObjectsHere folder can be left untouched and will not be affected by the upgrade process.
By default WebsydianExpress is installed in "C:\Program Files\Websydian\WebsydianExpress v1.1 for Windows and iSeries". In the rest of this document this folder will be named the WebsydianExpress folder. If you have installed WebsydianExpress in another folder then replace all references to the WebsydianExpress folder with your local installation folder.
When a relative path name is used (e.g. Application Services\Html) it should be resolved relatively to the WebsydianExpress folder so the full path would be "C:\Program Files\Websydian\WebsydianExpress v1.1 for Windows\Application Services\Html".
The first step is to stop WebsydianExpress:
Stop WebsydianExpress using the StopWebsydianExpress command found in the WebsydianExpress folder.
On the web server stop the WebsydianExpress application. If you useApache Tomcat this can be done from the Tomcat Web Application Manager.
It is important that you backup your WebsydianExpress installation before you start the upgrade process in case something should go wrong.
Disclaimer: Websydian A/S cannot in any way be held responsible for failures or errors caused by the upgrade process.
Backup the following:
Complete the following steps to upgrade Windows objects:
Unpack the upgrade package (WXPW12UPG.ZIP) to the WebsydianExpress folder overwriting all existing objects.
Run the update.cmd command found in the WebsydianExpress folder.
A number of changes to the configuration files of WebsydianExpress has to be manually changed, please perform the following steps:
Open the Settings.cmd located in the folder "Application Service" using notepad and change the following settings as specified below:
SET JAVA_HOME=..\Common\jre1.5.0_08
SET JARS_DIR=..\Common\jars
Open the WebsydianServer.prop located in the folder "Websydian Server" using notepad and change the following settings as specified below:
log.filename=../logs/websydianserver.log
Open the Express.ini located in the folder "Application Service" using notepad and change the following settings as specified below:
[Message Box]
Log File=..\logs\applicationservices.log
Transfer the save file WXPW12UPG, found in the folder named 'iSeries' in the WebsydianExpress folder, and restore the library WXPW12UPG on your iSeries.
Add the library WXPW12UPG to your library list
===> addlible WXPW12UPG
Execute the command WXPWUPG located in the library WXPW12UPG, make sure to prompt the command using F4.
*ALLOBJ authority is required to run the WXPWUPG command
Online documentation - WebsydianExpress v3.5
Upgrade WebsydianExpress (WXPWUPG)
Type choices, press Enter.
Program library . . . . . . . . WXP11WPGM Library Name
Database library . . . . . . . . WXP11WDB Library Name
PTF library . . . . . . . . . . WXP11WPTF Library Name
Slut
F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display
F24=More keys
Specify the program library of your WebsydianExpress installation.
Specify the database library of your WebsydianExpress installation.
Specify the PTF library of your WebsydianExpress installation.
Use the DSPJOBLOG command to verify the upgrade was successful. Message "UPGRADE SUCCESSFULL" has been written to the joblog.
Remove any Websydian supplied objects found in the WebsydianExpress PTF library. Default for WebsydianExpress v1.1 this is named WXP11WPTF.
Open the RelayService.prop file located in the folder "Relay Service" using notepad and add the following setting:
servlet.errorpage.url=/error.jsp
For upgrading the Servlet Web Server Component you have the following options:
Execute the Pack.exe located in the folder "Relay Service".
Press the next buttons to accept the settings used during installation.
Please note that the settings being used by the packaging tool is the once selected at the initial installation of WebsydianExpress.
Redeploy the Express.war file located in the folder "Relay Service" to your servlet engine.
Note that the packaging tool (pack.exe) will prompt you to deploy the Websydian Web Server Component on the local computer if a Tomcat Servlet Engine is installed.
If you are familiar with war files and understand the structure you can perform the upgrade of the Servlet Web Server Component by copying the content of the folder "Manual Upgrade" located in the upgrade package under the "Relay Service" folder to your express.war file.
Remember to remove the file WSYDDWA20.jar file from the folder "WEB-INF\lib" in your express.war file.
We can perform the upgrade of your express.war file for you if you do not feel like you are up for the challenge, just send the following information to support@websydianexpress.com: